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I 

INTRODUCTION 



The object of an assembly program is to allow the programmer 
to code instruction for instruction like actual machine lan- 
guage, but to be relieved of the extra chores of optimizing, 
keeping track of used locations, etc. With the "one over one" 
addressing system of the RPC-4000, optimization is doubly nec- 
essary. It w»% with these considerations in mind that the 
first major program for the RPC-4000 should be a symbolic ass- 
embler and optimizer. 

The overall scheme is this: 

The programmer codes his program either in sym- 
bolic language or a combination of symbolic lan- 
guage and machine language. The program is then 
processed by ROAR. 

The output of ROAR is of a dual nature. There are 

1. A hex tape of the assembled program. 

2. A decimal copy of the assembled program 
along with a reproduction of the input. 

These provide the programmer with a ready means of loading 
his program as well as a complete record for error correction 
and program checkout. 

On the following pages will be presented a list of defini- 
tions of the terms and abbreviations used in the rest of 
the manual. 
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u 

L 

X 

C 

FWA 

LWA 

Lo 

LOC 

D-ADDR 

N-ADDR 

ORDER 

SUBROUTINE 



Upper half of the double length accumulator 

Lower half of the double length accumulator 

Index register 

Command register 

First word address, as of table 

Last word address 

First location of, as a table 

Location, as of an instruction 

Data address; bits 5 through 17 of the 
command word 

Next address, the address where the next 
instruction is located. Also bits 18-30 of the 
command word 

The instruction code. Bits 0-4 of the command 
word 

A part of a program. A program used as a part 

of a larger program to perform a specific function 



SYMBOLIC ADDRESS A symbol to which ROAR assigns a machine address. 
A symrol contains at least one character that is 
not numeric 



RECRC 

DB 

BLOCK 

PROGRAM 

BC 



NU 



Refers to track 127, the 8 word recirculating 
track 

Double Access code 

An area of sequential drum storage 

Unless - specified as assembly program, program 
refers to the object program - the program being 
coded 

Branch control, an internal sense toggle and 
overflow indicator 

Replace (Replaces) 

Not used 
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PSEUDO OPERATION 



AVAILABLE 



An instruction to the assembly program,. It takes 
the same form as an instruction and is reproduced 
on the printed output* It is not output into the 
program tape. 

An available memory location may be used by ROAR 
for assignment as an instruction or constant, at 
which time it is made unavailable 



UNAVAILABLE 



RESERVE 
REPEAT MODE 



A memory location is unavailable when it has been 
reserved through a pseudo-op or assigned by the 
assembler . Double access tracks and RECRC are un- 
available unless specifically made available. 

To make a memory location unavailable 

The mode of operation in which the. execution of 
an instruction is repeated as specified 

Applies to the scaling convention we use, Q rep- 
resents the bit position in the data word that 
separates integer from fraction. Mathematically? 
the number to be represented is equal to the data 
word (which is considered as a fraction) multi- 
plied by 23 



-3- 



II 



A BRIEF DESCRIPTION OF THE RPC-4G00 



This ehapter is designed to provide a programmer's view of the RPC-4000 and 
to acquaint the reader with some of the terms used by the assembler,, 



MAIN MEMORY 

The memory consists of 8192 addresses broken into 128 tracks of 64 sectors,, 
Some of these addresses are redundent as we shall see „ Tracks 000 through 
122 contain nothing special and may be referred to directly c Tracks 123 and 
124 are the leading heads of two double access tracks and, if double access 
is not to be used, may be used as two more tracks of main memory „ Track 125 
is the trailing head 16 word times behind the head of track I23g track 126 
trails the head of track 124 by 24 word times „ 

Track 127 is an eight word recirculating line (RECRC) In other words, the 
group of eight words represented by sectors 00 - 07 is duplicated 8 times as 
08 - 15, 16 - 23, etc 

The following table will show the correspondence between the various sectors 
of track 127 as well as provide a presentation of modulo 8 equivalence for 
later consideration The RECRC notation will be discussed in Chapter IV 9 
All the sectors on each line refer to a single word of memory a 



RECRC0 or RECRC8 00 08 16 24 32 40 .48 56 

RECRC1 

RECRC2 

RECRC3 

SECRC4 

'RI1CRC5 

RECRC6 

RECRC7 



01 


09 


17 


25 


33 


41 


49 


57 


02 


10 


18 


26 


2A 


42 


50 


58 


03 


11 


.1.9 


27 


35 


43 


51 


59 


04 


12 


20 


28 


36 


44 


52 


60 


05 


13 


21 


29 


37 


45 


53 


61 


06 


14 


22 


30 


38 


46 


54 


62 


07 


15 


23 


31 


39 


47 


55 


63 



COMMAND EXECUTION 



Figure 1 



The normal operation of the "one over one" address system is as follows? 

As an instruction enters the C register, the indicated opera- 
tion is performed upon the memory location specified by the 
D address The next instruction to be executed is located in 
the memory location given in the N address e 
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TIMING 

Instruction timing is generally discussed in terms somewhat removed from di- 
rect application to programming. We speak of n milliseconds access time or an 
addition requiring X microseconds. For the purposes of the programmer this 
is cumbersome. We plan to relate instruction timing to optimization and, for 
this purpose, two time units are sufficient. 



They are: 



1 



The drum revolution 



1/60 second 

16 2/3 millisecond 



2. The word time 1/64 drum revolution 

260.4 microsecond 

The time required for word transfer 
between registers and memory 

For this discussion we will neglect the track since nothing in timing depends 
on it. 



Let us begin, as in COMMAND EXECUTION, with an instruction entering the C reg- 
ister. At this point the computer is entering phase 3 of a four phase oper- 
ation. During phase 3 the computer is concerned with waiting while the drum 
rotates until the next sector is the one specified in the D address, The min- 
imum time for phase 3 is one word time, so that for best optimization the D 
sector will be two greater than the sector in which the instruction is located. 



As an illustration 



"T 



P?\ v&ALL 



T 



.££. 



4 — 1_ 



jcjs} 



SECTOR OCCURRENCE 

03 Instruction came from sector 3 

04 Phase 3 Search for "next sector is it" 

05 Operand sector 
06 



NCWl 



This is the most optimum case. Consider a case which is less optimum: 

1 — *— — ' - 



±_ L , ,0.J\- .RAU\ , . . .afi 



T 



^x&. 



SECTOR OCCURRENCE 



03 
04 
05 
06 
07 
08 
09 



Instruction came from sector 3 

Phase 3 Search for "next sector is it* 

Wait 

Wait 

Now 

Operand Sector 



Wait 



Once the computer establishes that the next sector is the operand sector, phase 
4 is entered. Phase 4 is the execution phase of the instruction (see below). 

Phase 3 is limited to one word time on the following instructions: 



HLT-SNS 


00 


CXE 


01 


LDX 


07 


INP 


08 



SRL 


12 


SLC 


13 


PRD* 


16 


PRU* 


17 



so that the sector used is generally immaterial, 



The time in phase 4 depends upon the instruction being executed: 

Shift orders take 4 word times plus 1 word time for each 
bit position shifted. 

The multiply and both divide orders require 67 word times 
of execution. 

The input order is variable, depending upon the number of 
characters read. 

All other orders require 1 word time in phase 4. 

After execution, phase 1 is entered. Phase 1 is the search for the sector of 
the next instruction and requires a minimum of one word time in the same manner 
as phase 3. In phase 2, the instruction enters the command register and the 
cycle is complete* 

As an example, consider the following instruction sequence: 



CO 



location 



) ■ S,O.0 



UJL 



< * » ■ ■ 



Order 



,R,AU 



JPV 



_i i i_ 



Data 
Address 



j — t=u 



Z.oy 



L3 



i * i 



4 — A — » — 4 — J- 



Next 
Address 



_j i 



UJL 



+-»- 



A1A 



4 i i ) 



*Sectors of print orders must not be first optimum unless it is desired to 
bypass the print interlock. 
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SECTOR' TIME 



ACTIVITY 



00 
01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 



Phase 2 Command 1 enters C register 
Phase 3 Search for sector 07 to be next 



07 is next 

Phase 4 Contents of 0307 to upper 

Phase 1 Begin search for sector 12 



12 is next 

Phase 2 Command 2 to C register 
Phase 3 Begin search for sector 14; Next 
Phase 4 Add C(0014) to upper 
Phase 1 Begin search for sector 15s Long 
wait 



Note 



1. Command 1 is moderately optimum „ 

2. Execution of command 2 is first optimum, 

3. The N address of command 2 calls for the least optimum sector. 

Print orders require one word time for execution,, Further printing will be 
held up by an interlock until the previous print stroke is completed* 

To summarize instruction timing for the RPC-4000, the following table will 
illustrate in terms of the phase structure,, 



Phase 



1. 



"W. 



3. 



Activity 

Search to determine that the next 

sector contains the instruction-; 1 to 
64 word times 

Copy instruction into command register, 
adding indexing portion of X register 
if indexed? 1 word time 

Search to determine that the next 

sector contains operands 1 to 64 
word times (phase 3 is MMtM to 1 
word time on certain instructions) 

Execution of command,, This is a fixed 
©r variable amount and depends upon 

the order. 
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Note About Repeat Mode 

Repeat mode operation means extended phase 4 operation. 
In repeat mode, the execution portion (phase 4) is extended (or 
repeated) as many times as the count indicates (see repeat mode of 
operation page II) « 



WORD STRUCTURE 



Command Word 



1 i w i i hJ i h um— i— i— n ■liiUM ■ >■ I ihiii, ii JL. Li|-|iiiini.lLiui hi "mi in hJii ■ ii J L I n iii im n-ii—nu ■ It II Ml i i -J ■!' milJl ■ i -ii i ■!■ unilk I 



Order 



/ D Track 



/ D Sects 




.8fL9E0 



/ N Track 



/ N Sector / X 



Data Word 







Lower Accumulator when used as lower § of product, numerator for 
division. When used, for other functions it uses the data word form. 



^"^^^^^^^^^^^^^j|f 



B2 



INDEX REGISTER 




NU 



ij2j3 |4]ip]7 jfj^H^^SSESL^SsE. 3 




Not used / X Track 



/ X Sector / Repeat count / Found sector /NU 

+ 1 from com- 
pare memory 
instructions 



-8- 



REGISTERS 

The RPC-4000 has four registers: 

L Command Register C 

2 . Upper Accumulator U 

3„ Lower Accumulator L 

4. Index Register X 

Command Regis ter C 

The command register analyzes the instruction word,, The general interpretation 
of most commands is: Perform the indicated operation upon the contents of the 
memory location specified by the D address and find the next instruction in the 
location specified by the N address „ 



Upper Accumula tor U 

The Upper is a one word accumulator capable of arithmetic use. It holds the 
multiplicand and high order product for multiplication, the high order portion 
of the dividend and the quotient for division and its sign bit is checked by 
the test on minus instruction. 



Lower Accumulat or L 

The lower accumulator may be specified by programming as one or eight words in 
length. It may be added to, subtracted from 3 and shifted in conjunction with 
the upper « During addition and subtraction there is no carry between upper and 
lower, nor between units of the 8 word lower „ 

For division L holds the lower half of the dividend, then the remainder . For 
multiplication it holds the lower half of the double length product. After a 
shift and count its D address bits hold the number of places shifted . 

L is utilized as a mask holder for the compare memory instructions. 

Index Register X 

The X register has several varied uses as follows: 

1 = Its primary use is as an index register: 

If an instruction is indexed, i „ e,, it contains the index bit 
(a one at 31), the D address portion of the index register is 
added to the D address of the instruction as it goes into the 
command register. The index register portion may be loaded by 
use of the LDX (07) order. It may be incremented by an indexed 
LDX order: "Load the X register with the D address of the LDX 
order, after adding in the previous contents of the X register." 



The index register portion of the X register may be tested by use 
of the CXE (01) order followed by a TBC (23) order. 

2. For repeat mode instructions, e. g. , using the compare memory 
orders as a table look-up, adding a column of figures, etc, the 
N track holds and counts down the repeat count, 

3. On the compare memory instructions, one greater than the sector 
where found, or one greater than the last sector searched (if not 
found), is placed in the N sector of the X register. 

4. When not otherwise in use, the X register, through the use or the 
EXC (09) order s becomes a word of immediate access, high speed 
storage. 



Branch Control 

The Branch Control is not truly a register but an internal toggle which is 
capable of being in an on or off position. 

The following conditions will turn it on; 

A. Overflow conditions resulting from: 

Add and subtract in either upper or lower 
Either divide 

B. Shifting a bit left beyond the normalized position in 
the upper. 

C. Successful compare (memory, X) instructions 

D. A successful match on SNS (00) instruction 
The Branch Control is turned off in the following ways: 

A, As the first step in executing these instructions: 

SNS (00) Sense (not halt) 

CXE (01) Compare index register 

GME (20) Compare memory equal 

CMG (21) Compare memory greater than or equal 

B. Upon execution of the TBC (23) instruction (if on) 

SPECIAL FEATURES 

Lengthened Lower Accumulator 

The lower accumulator may be either one or eight words in length as deter- 
mined by the EXC (09) order , The 16 's bit in the D track of the exchange 
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command changes it to 8 word lengthy the 32 5 s bit changes it to one word 
length. The lengthened Lower may tjje read into, and may perform all arithmet- 
ical instructions that the one word Lower is capable of, either one word at a 
time by judicious placing of an operand in memory, or several words at a time 
by making use of the repeat mode of operation. 

The programmed timing for the 8 word Lower is quite straightforward. It is 
timing modulo 8„ A word entering the 8 word Lower from memory sector zero 9 
for example, may only be operated on, stored into or replaced from a sector 
zero location, modulo 85 that is sector 0,8,16,24,32,40,48, or 56, of a 
track. (See figure 1„) 

It is suggested that shifting be not done when the lower is lengthened* If 
programmed, left shifting into the upper will be a bit in turn from each of 
the lowers for the duration of the shift. 



Repeat Mode 

If the LDC (06) instruction is executed f the N track of the X register will 
be replaced by the corresponding bits from the memory location specified in 
the D address, and the execution of the succeeding instruction will be repeat- 
ed as many times as given in that count „ 

An example of this operation will be given in Programming Example l,M&R;'#Age 40 
following the discussion on coding. This tool is expected to prove very 
powerful, for it enables us to perform table look-up (repeated CME or CMG) , 
add a column of numbers (repeated ADU) , move blocks of data (repeated RAL, 
STL coupled with the 8 word Lower), etc. 

Track switching is not possible in repeat mode* For example, assume a count 
of 5 is loaded, followed by a CME (20) 0960 XX„ The locations searched are 
0960, 0961, 0962, 0963, 0900, 0901 in that order,, 

C ommand Structure 

The following table provides a brief description of the RPC 4000 command 
structure; 
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ORDER ORDER D ADDRESS 
SYMBOL NUMBER 



OPERATION 



TRACK SECTOR 



HLT 
SNS 



00 
00 



000 
*000 



CXE 



01 



RAU 



RAL 



SAU 



02 



03 



04 



MST 



05 



Any HALT 

Any SENSE 

No operation^ Turn the Branch Control 
on if a track bit (or more) corresponds 
to a depressed sense switch on the 
console. The track 64 bit will always 
turn the Branch Control on. 

B COMPARE X EQUAL 

1. Turn the BC off. 

2. Compare the bits of the D address 
with the corresponding bits of the 
X register* 

3. If equal, turn BC on„ 

B RESET - ADD UPPER 

Replace the contents of U with the 
contents of memory location A B 

B RESET - ADD LOWER 

Replace the contents of L with the 
contents of memory location AB 

B STORE ADDRESS FROM UPPER 

Store the D portion of U in the locat- 
ion specified by AB, leaving the rest 
of the word unchanged 

B MASKED STORE 

Where U contains l a s store L into 
memory location AB? where U contains 
0*s, leave the memory location unaltered 



U 



N.U. 



N.U. 



N.U, 



C(AB)-»U 



N.U. 



D copied 
Register 
left un- 
changed 

Mask 



EFFECT ON 

L 

N.U. 
N.U. 



X 

Index 

Index 



N.U, 



N.U. 



C(AB)*L 



N.U, 



D addr. 
compared 
Indexing 
is re- 
dundent 



Index 



Index 



Index 



Data 
word 



Index 



SYMMr 0RMR DA ^RESS 
SYMBOL NUMBER ■ 

TRACK SECTOR 

LDC 



06 



B 



LDX 



07 



B 



INP 
INP 



08 
08 



EXC 



09 



000 

064 



N„U, 
N„U« 



01 



B 



02 

04 

08 

16 Timing 

32 Timing 

64 



OPERATION 

LOAD COUNT 

Replace the contents of the N track 

bit J nf rSglSter with -We corresponding 
bits of memory location AB. Execute 

— P eatln - g bZ the amount pl ace d in x. 
LOAD X 

Load the indexing portion of the x 
regxster (the D address) with M «,«. n 
portion of the LDX order ' ° 

INPUT 

Read; 4 bit 
Readr 6 bit 

dfubliV* * 7° rd length > read into the 
aouble accumulator 

LgJ 30 In ! h r ! ad " diffe «nt from 

tftS ? J at th6re 1S no shi ^ Prior 
to the first digit entering 

EXCHANGE 

Replace the contents of the Lower with 
^contents of the Upper. th 

U->X 

x-»u 

Lower to 8 word length 
Lower to 1 word length 
Unspecified as yet 

Any combination of D-track bits is 
acceptable s 



U 



N.U. 



EFFECT ON 
L 



N.U. C(ABVC(N track) 



Index 



N.U. 



N.U. AB-»C(D addr.) 



Index 



Index 



Index 




ORDER ORDER D ADDRESS 
SYMBOL NUMBER TRACR SECT0R 



DVU 



10 



B 



OPERATION 



DIVIDE UPPER 

divide the Upper by C(AB) : 
retain the quotient in U and 
remainder in L 



the 



U 



EFFECT ON 
L 



Dividend,, 0, 
Quotient Remainder 



X 
Index 



DIV 



11 



SRL 



O J. A.-; 



12 000 B 



12 001 B 



13 N„U„ N„U, 



DIVIDE 

Divide the double length accumulator 

by C(AB) 



SHIFT RIGHT OR LEFT 

Shift the double length accumulator 

right by B bits „ 

Shift the double length accumulator 
left by B bits. If an overflow is 
detected, turn BC on, 

SHIFT LEFT AND COUNT 
Normalize the double length number. 
Shift left until the most significant 
bit is in the high order position of 
the upper. After shifting clear the 
lower to zeroes and place the number of 
bits shifted in D sector of L, 



Index 



High 
dividend, 



11 



Low 
dividends 



Quotient Remainder 



Index 



Index 



Index 



ORDER ORDER D ADDRESS 

SYMBOL NUMBER 



MPY 



14 



TRACK SECTOR 
A B 



OPERATION 



U 



EFFECT ON 
L 



MULTIPLY Multiplicand, 

Clear the lower to zero. Multiply the High order 
upper accumulator by the contents of product 
memory location AB and develop the 
product in the double length 
accumulator. 



Zero, Lower 
half of Index 

product 



MPT 



15 



000 



MULTIPLY BY TEN 

Multiply the upper accumulator by 

10, 



C(U)xlO-#G(U) 



N.U, 



Index 



PRD 



PRU 



EXT 



16 



17 



18 



064 B 
A<64 B 

/as64 B 



A<64 B 



064 



A 



Multiply the lower accumulator 

by 10, 

PRINT DATA ADDRESS 

Print the character represented by 

A on the selected output device. 

Select the input and/or output 
device(s) indicated by A 

If the automatic interlock is to be 
made use of, B must not be the first 
optimum sector 

PRINT FRCM UPPER 

Print the left four bits of the upper 
as channels 1-4 and take channels 
5 and 6 from D track of print order 

Print the left six bits of the upper 
accumulator 

EXTRACT 

Make the upper zero where memory locat- 
ion AB contains zeroes; do not change 
the upper when C(AB) has ones 
(LGP-30 extract) 



N..U. 

N,U, 

N.U. 



CCL)xl0-*CL) 



Sign and 
left 3 bits 



Sign and 
left 5 bits < 

C(AB)EXT-*U 



N,U< 



N,U S 



N.U S 



N,U„ 



Index 



Index 



Index 



Index 



ORDER ORDER D ADDRESS 
SYMBOL NUMBER 



MML 



19 



TRACK SECTOR 
B 



CME 



20 



CMC 



21 



MI 



22 



B 



TBC 



23 



OPERATION 



MASKED MERGE LOWER (formerly Collate) 
"Masked Bring*" For the bit positions 
where the upper contains zeroes, retain 
the contents of the lower. For the 
positions where the upper contains ones , 
replace the contents of the lower with 
the contents of memory location AB 

COMPARE MEMORY EQUAL 

Compare the upper with memory location 
AB in the bits where the lower contains 
ones. If they are equal, turn BC on 
and place the sector plus one in the 
N sector of the X register. BC is 
turned off immediately before compar- 
ison begins 

COMPARE MEMORY GREATER 

Compare upper with memory under the same 
conditions as CME except that BC will 
be turned on if C(AB) is algebraicly 
greater than or equal to CCU) in the 
bits compared 

TEST MINUS 

If the sign bit of the upper contains 
a one, take the next instruction from 
AB, If not, take the next instruction 
from the N addr, as usual 

TEST BRANCH CONTROL 

If BC is on, turn it off and take the 
next instruction from AB. If nbt proceed 
to N addr„ as usual 



U 



Mask 



Control 
word 



Control 
word 



EFFECT ON 

Left alone 

or 

replaced 



X 
Index 



Mask 



Mask 



Sign 

cheeked 



N.U. 



N.U. 



N.U. 



Index 

Sector 

"found"-* 1 
♦N sector 



Sector 
"found" 
♦1 — »■ 
N sector 



Index 



Index 



ORDER 
SYMBOL 

STU 



ORDER 
NUMBER 

24 



STL 



25 



GUI 



26 



v-sj-slj 



21 



ADU 



28 



ADL 



29 



D ADDRESS 
TRACK SECTOR 

A B 



A 



OPERATION 



STORE UPPER 

Replace the contents of memory- 
location AB with the contents of the 
upper accumulator; leave the upper 
unchanged . 

STORE LOWER 

Replace the contents of memory locat- 
ion AB with the contents of the lower; 
leave the lower unchanged, 

CLEAR UPPER 

Replace the contents of memory location 
AB with the contents of the upper accum- 
ulator, then clear the upper to zeroes, 

CLEAR LOWER 

Replace the contents of memory location 
AB with the contents of the lower, then 
set the lower to zeroes 

ADD UPPER 

Add algebraicly the contents of memory- 
location AB to the contents of the 
upper, leaving the sum in the upper. 
An overflow will turn BC on. 

ADD LOWER 

Add algebraicly the contents of 
memory location AB to the contents of 
the lower, leaving the sum in the lower. 
An overflow will turn BC on. 



U 

Stored, 
unaltered 



EFFECT ON 
L 

N.U, 



X 
Index 



N.U, 



Stored 

unaltered 



Index 



G(U)-*CCAB) 
zero~*G(U) 



N.U. 



Index 



N.U, 



C(L)-+C(AB) 
zero-*G(L) 



Index 



C(U)+C(AB) 

-♦ecu) 



N.U, 



Index 



N.U. 



CCL) + C(AB) 
-*C(L) 



Index 



ORDER ORDER 
SYMBOL NUMBER 



SBU 



30 



SBL 



31 



1 ADDRESS 
TRACK SECTOR 
A B 



OPERATION 



SUBTRACT FROM UPPER 

Subtract algebraiciy the contents 

of memory location AB Srosir ttte^ "••""> sv 

upper; leave the difference in 

the upper. An overflow turns 

BC on. 

SUBTRACT FROM LOWER, 

Subtract algebraiciy the contents 

of memory location AB from the contents 

of the lower, leaving the difference 

in the lower. An overflow turns 

BC on. 



U 



EFFECT ON 

L 



C(U) - C(AB) N.U. 
-» C(U) 



x 

Index 



N.U. 



C(L)-#ftfe) 
■-* C(L) 



Index 



ALPHANUMERIC CODES 

The following list gives the tape codes and internal configurations of the 
typewriter keyboard. 



NUMERIC 


DEFINITION 


BINARY 


00 


Tape feed 


000000 


01 


Carriage 






return 


000001 


02 


Tab 




000010 


03 


Backspace 


000011 


04 


Color Shift 


000100 


05 


Upper Case 


000101 


06 


Lower Case 


000110 


07 


Ijine feed 


000111 


08 


*Stop Code 


001000 


09 






001001 


10 






001010 


11 






001011 


12 






001100 


13 


Photo Reader 


001101 


14 






001110 


15 


End 


of Block 


001111 


16 





o> 


010000 


17 


1 


010001 


18 


2 


*J 


010010 


19 


3 


# 


010011 


20 


4 


T, 


010100 


21 


5 


A 


010101 


22 


6 


@ 


010110 


23 


7 


, & 


010111 


24 


8 




011000 


25 


9 


( 


011001 


26 


A 




011010 


27 


B 




011011 


28 


C 




011100 


29 


D 




011101 


30 


E 




011110 


31 


F 




011111 



NUMERIC DEFINITION 



32 

33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
51 
58 
59 
60 
61 
62 
63 



BINARY 



100000 



H 


100001 


I 


100010 


J 


100011 


K 


100100 


L 


100101 


M 


100110 


N 


100111 





101000 


P 


101001 


Q 


101010 


R 


101011 


S 


101100 


T 


101101 


U 


101110 


V 


101111 


W 


110000 


X 


110001 


Y 


110010 


Z 


110011 


s $ 


110100 


= 


110101 


\ \ 


110110 


3 % 


110111 




111000 




111001 


+ ? 


111010 


- 


111011 


* * 


111100 


Space 


111101 


/ * 


111110 


Code delete 


111111 



D^/efe 




p*»- 



.+} 



(eve*) 



Motion 
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Location 


Order 


Data 
Address 


Next 
Address 


Comments 




» ' 




i 


i 

1 iiit 
























i 
























i 
























i i 
























i i 


.--;-..-:..---;-- — -.- ■,.,.-..--■..■_....,. ■ _ _ 






















i 
























• 
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■'-■■■■•■■ -;■■"■-—■-■-■■--:■■■■-,;..-—..,.■■.■ : ..,-, 7 --" - ■.-■■ ' 


♦7 




















• 
























i 




JO 




















■ ..+. _ 




(V 




















i 




^ 




















i 
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THE ASSEMBLY PRGGRAM 



CODING SHEET FOR THE ASSEMBLY PROGRAM 

Figure 2 shows a sample of the coding form for the RPC 4000 <> 

It may be used equally well for machine language programs and symbolically 

coded programs. 



ORDERS 

Two types of orders are accepted by the Symbolic Assembler. They are 
machine orders and pseudo operations,, Pseudo operations are instructions 
to the assembly program itself and are not reproduced as such into the 
program being processed. See the chapter on pseudo operations*, 

Machine orders may be entered on the coding sheet in either symbolic or 
numeric form. It makes no difference to ROAR which form is used„ Provision 
has been made in the coding of ROAR for the user to add or change such 
symbolic codes as he desires — LGP-30 programmers may well wish to use B 
for RAU, etc, if so the addition is not difficult* 



Indexed Instructions 



If an instruction is to be indexed, include an X immediately to the left 
of the 2 or 3 character order code. 



Examples 



Location 



Order 



Data 
Address 



Next 
Address 



Comments 



-i i j. 



i i i_ 



i iL/\J* 



J I I L. 



iXxQO* 



1 ' ■ ' ' 



Resets A<U Upper 



J I L. 



&AJI 



XnJexeJ R&setj AJJUpf>e\ 



+- 1 - 



-J t — u 



_1 I I 1- 



Rese t, A 4 J Upper 



J. I L. 



xAAdl 



j i_ 



J I 1_ 



Xj, JtJta J tfese tj AJJ UftfA * 
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MEMORY SETUP FOR THE ASSEMBLED PROGRAM 

In assembling an object program, the Assembler has in memory only one instruc- 
tion at a time. Immediately as it is assembled, it is punched out in hex 
and printed in decimal- Since this is true, the entire memory of the computer 
is available to the assembled program. 

At the beginning of assembly, all of "normal" memory, that is, tracks 000-122, 
is available for program „ Normally, it will be necessary for the programmer 
to reserve various parts of memory for data storage, tables, etc* It is also 
necessary for the programmer to provide one track for the bootstrap program 
which loads his program* This bootstrap area may be utilized later for data 
storage, etc. 

ROAR provides two pseudo operation codes to reserve various areas of the 
drum. They may be used at any time, but normally will be among the first 
instructions assembled* 



R eserve A Portion Of Memory ; RES 

This pseudo operation directs the Assembler to reserve the portion of 
memory between the FWA and the LWA„ All locations between (and including) 
these addresses are made unavailable for symbol assignment. The FWA and 
LWA must be numeric addresses, (see the section on addresses which follows). 

EXAMPLE 



Location 



I ,. ,»,,,! I 



Order 



,e\S 



Data 
Address 



j i 



LOjO 



Next 
Address 



J LSd-t 



.5.1.6*2. 



Comments 



This will make memory locations 100 through 563 unavailable, 



Set Up a Region: REG 

1. A region is a set of sequential memory locations which may be referred 
to by "regional addresses''" (See Addresses). 

2. Regions are distinguished by a one character code which is defined 
with th© REG command. 

3. The locations within a region are reserved in a manner similar to the 
RES order „ 
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Location 



J — i ii i 



Order 



AMI 



Data 
Address 



giW , V 



Next 
Address 



itt? 



will reserve region B from 300 through 463, 



Make a Block Available: AVL 

The function of this pseudo operation is the reverse of RES. It will 
serve to make the locations from FWA to L¥A available for program as- 
signment. The only time it would be meaningful to employ the AVL order 
at the beginning of a program is in the event that one or both of the 
double access tracks will not be used for double access, The leading 
(or trailing) head may be. made available to general program use. Note 
should be taken that making available both heads of a double access 
track could lead to disastrous results, (See the section on Double 
Access, page 28). 



Comments 



Example: 



Location 



r 



i— I — I i ■ i ■ 



Order 



AM-t- 



Data 
Address 



\!t$yO-P 



Next 
Address 



/>ux? 



Comments 



Makes available the block 12300 - 12363. 



,23 = 



IV 
ADDRESSES 



Before discussing coding methods and techniques it is necessary that a 
complete discussion of addresses and addressing be presented. 

An address in the final program will be in track and sector form. One of 
the major reasons for having an assembly routine, however, is to allow the 
programmer to be relieved of the task of assigning these machine language 
addresses, and to permit him to refer to operands and instructions in a 
convenient shorthand notation. 

ROAR provides several methods for addressing memory locations in order that 
the programmer may allow the assembler to do as much or as little as he 
desires. 



Location 



Order 



Data 
Address 



Next 
Address 



Comments 



A t + 



i ii i_ 



J I L 



A 



_J L 



-> 



A f^T^T^ 



J L. 



_l I L 



_l I 1 1_ 



J I I L. 



£uL 



Q,VY.€, J 



J i i i u 



In the sample coding sheet (figure 3) , note the columns marked Location, 
Data Address and Next Address. These are the columns that may contain 
addresses. These addresses consist of a left hand character (A) separated 
from the right hand five characters (B). 

If a character is placed in the left hand box, it indicates a special ad- 
dress. Let us first consider addresses without the "special" character. 

These normal or "non-special" addresses are of two types, symbolic and 
numeric. 



Symbolic Addresses 

Symbolic addresses are one through five characters in length. They contain 
at least one character that is not numeric. For this purpose any character 
that may be read into the computer is acceptable except specifically the 
digits zero through nine. 
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Symbolic addresses are assigned memory location equivalents by the assembly 
routine when they are first encountered and retain this equivalence through- 
out the program. Such equivalent locations are then made unavailable. 
Symbols may be preset to a particular value through the use of the pseudo 
operation codes EQR and EQV which are discussed later. 



Some typical symbolic addresses might be: 



Address 



Numeric Addresses: 



| i i i tA 


| i i i/i4 


\ , . J,l 


\ ,R,AXX 


\B.E6.M 


; , ,^3.l 


>.€.P.B.L 


! , ,/A/ 


\i AJX9 


\ . ,?X4 


J//.2.P.I 


\?,'J.4.l 



Numeric addresses refer to drum addresses and are in track and sector form 
with the exceptions mentioned below. It is not necessary to include 
leading zeroes in numeric addresses. The memory locations corresponding to 
numeric addresses are not made unavailable? if numeric addressing of data or 
instructions is to be used, the locations should be reserved in advance by 
a RES pseudo-op. 



Special Sectors For Numeric Addresses: 

In order to have the ability to select a particular word of the 8 word Lower, 
certain instructions were allowed to operate at a particular sector time: 
EXC (09), MPT (15). Normally we are not concerned with this feature and 
would like to have the Assembly Program merely assign an optimum sector. 

At other times it is desirable to specify the action of these orders to 
operate on a particular word of the lengthed Lower. 

Since we can completely describe the sectors of a track with the numbers 
00-63, we have the remainder (64-99) available for these other purposes. 

We have, then, assigned the sectors of the 90* s as follows: the track will 
remain as assigned by the programmer: 
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90-97 



98 
99 



The second character refers to a prime sector, modulo; 8„ 

ROAR will assign the next optimum occurrence of this sector as the 

sector address. As an example , if the next Optimum sector 

were 34 and the given sector address, 93, the first optimum 

modulo eight 3 would be sector 35 . See figure 1„ 

Assign the first optimum sector, 

Assign the same sector as is contained in the location of the 
instruction. 



Location 



Order 



Data 
Address 



Next 
Address 



Comments 



J L. 



| ■ I I L. 



£A£. 



Si? i& 



j i i — i- 



t P t RJ> 



j i_ 



LIB. 



V-*L } U~»X .op-hma/ly 



J J 1 L L. 



Cmrrtai oS iret'u^n 



The sector 99 is desirable since print interlocking is bypassed 
if and only if the sector of the D address of the print order 
is first optimum; normally this bypassing is not desirable 
We can be certain that if the D sector is the same as the LOG 
sector, it will not be optimum. 

Note that these special sectors apply only to D and N addresses; if a location 
were thus assigned it could never be referred to again. 



Blank Addresses; 



Addresses may be left blank subject to certain conditions. 

If the D or N address (but not both) of an instruction is left blank, it will 
be assigned an available memory location (which is then made unavailable) and 
the location of the following instruction (or constant) will be given that 
address. If the D or N address of an instruction is left blank, the location 
of the following instruction must also be left blank. 

Obviously, if a location is to be referred to from more than one place, it 
should be assigned a symbol rather than being left blank. Blank addresses 
are, in effect, symbolic addresses with the symbol implied. 



ADDRESSES CONTAINING THE "SPECIAL" CHARACTER; 
Regional Addresse s; 

A Regional Address consists of a region symbol (which must have been defined 
previously) and a five digit sequence number. The first memory location of a 
region is addressed as 00001. The sequence numbers are in true sequence, 
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not track and sector, so that 00105 would be the 105th word of the region. 

Comments 



Example; 



Address 



z 



r 



T 



T 



&£>\Q\Qil 



0&0JJ1 



&00&S 



0,0 X, 0,0 



-J I I l_ 



_1 I I l_ 



Q X X Q,0,Q 



J I L. 



An error stop will result 
region is used,, 



X5QO 



^56 3 



2-L&D 



u/at/tel beassia hedos 



X2o7<eve,<i thai^Ji it h*s 



xoi 6ec » raservtJ ,n th* 



r-e ffol 



A -rsy a£cLa. i 2 4 A 3 - 



>»g>/ mssxxid. 



if a regional address that refers to an undefined 



Addressing the Eight Word Recirculating Track (127) 

A special means of addressing the recirculating storage track has been devised. 
The eight storage locations have been assigned numbers corresponding to their 
prime modulo 8 sectors. They are numbered through 7 or 1 through 8 depending 
upon the desire of the programmer j sector and sector 8 in reality refer to 
the same sector „ 

Recirculating line sectors are addressed with the symbol RECRC followed by a 
prime sector , When the assembly program encounters a RECRC address, it assigns 
track 127 and the next optimum occurence of the indicated sector. See also 
figure 1„ 

Example: 



_i ' ' 1 



£u£.jCJL£iZ 



Assume the next optimum sector to be sector 5„ The next time a modulo 8 sev- 
en is available beginning with sector 5 is sector 7 itself. 
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■ |fljg,C.*.C5 ~ 

Assume the next optimum sector is sector 30. Modulo 8 5* & are 5, 13, 21, 29 ,-37, 
45,53,61, so the next available one is 37. The assembly routine therefore 
assigns 12737 for RECRC5 in this case. The programmer must keep track for 
himself of which RECRC sectors he is using,, Subroutine write-ups should provide 
a list of the RECRC sectors they use. 

Since the bootstrap program makes use of the recirculating track, any storage 
therein must be done by the program itself « 

If a RECRC address is used as a location, the contents will be printed as a 
part of the program listing, but will not be reproduced into the hex program 
tape. 



Using Double Access Tracks: 

If the double access tracks are to be used as such, they should be left unavail- 
able to other types of addressing. This is not difficult since it requires 
a pseudo-op to make them available. 

In this normal condition they may be addressed by special double access sym- 
bolic addressing; for this purpose, the following numeric codes have been assign- 
ed; 

Number Track 

1. Leading head of the 16 word track (123) 

2. Trailing head of the 16 word track (125) 

3. Leading head of the 24 word track (124) 

4. Trailing head of the 24 word track (126) 
The double access address consists of three parts: 



I, I L. 



b'.ftg.r. 3^*^ 



1= The letters DB with the D in the special 

column. 
.2. #The number as assigned above. 
3. A three character symbol, which characters 
may be any character capable of being read 
into the computer. 

A double access address, when assigned, may be used only by the track to 
which assigned or by its partner track. Tracks 1 and 2 are partners and 
tracks 3 and 4 are partners. 
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To illustrate this, consider the following program: 



Location 



-J 1 u 



EX 



i •- 1 



J i_ 



J L 



_i I U 



Order 



J L. 



x Sj-y 



,s,ri 



S.T.U 



£AJl 



Data 
Address 



j i i i_ 



P|g./ UAA 



-I — I — I 1_ 



J I 



1AR. 



^_2^VA& 



Next 
Address 



Comments 



Variable mlJ & X 



S~+arg ~ hetr>/? or*r,ly 



X, ? L+ Uu± i fr 



VambU & X 



<OA/ >fe r /me* V <l rt* h /Q 6>jV 



The instruction in EX stores the variable quantity in the first optimum sec- 
tor of the first double access track (16 word time) using the leading head. 

The DB symbol VAR is stored in the symbol table. 

The accumulator is shifted right by one bit and the variable at q - 8 is 
stored into a location symbolized VAR. This is the first assignment of VAR 
so it will be optimum. 

The fourth instruction replaces the variable in the accumulator at q - 7, 
read by the trailing head of the first double access track (16 word time). 

The assembly routine might have translated the instruction as follows: 



EX*STU*DB1VAR** 
*SRL*1** 
*STU*VAR** 
*RAU*DB2VAR*G0 ON* 



00105 24 12307 00009 
00009 12 00001 00217 
00217 24 00019 00021 
00021 02 12523 00125 



Variable in U at 7* 
Right 1: 8* 
Variable at 8* 
Replace variable at 7* 



Skip Address; 



At times, for the sake of optimization, it is desired to place an instruction 
at a distance beyond the first optimum. An example of this might be where 
the D address is variable and may be set to pick up the contents of one of 
several consecutive sectors, yet we want the next instruction to be as optimum 
as possible* 

To enable the programmer to do this, the Skip Address has been devised. For 
any D or N address that might otherwise have been blank , the letters SKIP, 
with the S in the special column, are used followed by a two digit number of 
sectors to be skipped beyond first optimum. 

The following example will illustrate: 

Locations 10520 through 10524 have been reserved for a set of parameters, one 
of which will have been chosen for use and its address placed in CODE. CODE 
has been defined as 00318. 
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Location 



Order 



Data 
Address 



Next 
Address 



Comments 



C*.P.g 



i"*i i 



■ Ml/. 



JLQ£J*Q 



. etc. 



Pm rmm* ttr -*■ ^ 



_i_ 



_i_ 



£LP1. 



A — i — i— 1_ 



A 



+3± 



D-ADDR 

The remaining special type of address is rather limited; it was designed for 
a specific condition. At times it is disired to turn the branch control off. 
This is done by coding a TBC instruction with the D and N addresses the same. 
In orderfor this to be done optimally, the N address must be location plus 
four sectors, but the D address would be optimized as location plus two sec- 
tors. If we were to use 'the same symbolic address for both, the D address 
would be optimized first as location plus two and any transfer to the N add- 
ress would waste a drum revolution* 

To cope with this, the D address is made a SKIP02 and the N address is given 
the code D-ADDR with D in the special column: 



Location 



1 ..I .J i-iJU J 



Order 



*JLS£L 



Data 
Address 



Si K.t t P,Q* 



Next 
Address 



PqAMA 



Comments 



The code D-ADDR in the N address column indicates that the N address is to 
be made the same as the D address. 

Examples Assume the location to be 01235„ 

*TBC*SKIP02*D~ADDR* 01235 23 00539 00539 

Instead of trying to place the D address in sector 37, the SKIP02 address 
.indicates that the search should begin with 2 greater -than the optimum sector, 
Or 39. Once defined, the N address is made the same as D through the D-ADDR 
address. 
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PSEUDO OPERATIONS 



A discussion of several of the pseudo-operations has already been included: 
REG, RES and AVL in chapter III. 

PRESETTING ADDRESSES 

Symbolic addresses may be fixed at any time. Generally the initial address 
of the program will be set. There are two pseudo operations to be used for 
presetting addresses. 



Equivalent, Reserve: EQR 



Location 



T 

■■1.1 I I L 



Order 



,E,Q,R 



Data 
Address 



1.T.7VU.T 



Next 
Address 



T 



| i / t^i 



/ 1 fj H 



Comments 



Upon reading the pseudo-op EQR, ROAR will do the following: 

1. Place in the symbol table the symbolic address given in the D address. 

2. a. If the N address is numeric, assign that address to the symbol. 

b. If the N address contains another type of address, assign the 
memory equivalent of that address to the symbol. 

c. If the N address is numeric, the sector must be in the range 
00 to 63. Blank, SKIP and D-ADDR are not legal addresses for 
this psendo-op. 

3. The memory equivalent as assigned in (2) is made unavailable (see 
Availability Table). 



Equivalent, Don't Reserve: EQV 



Location 



■ ' ' 



Order 



.F.ffy 



Data 
Address 



iIAMAa 



Next 
Address 



8,0,0,0,0,/ 



Comments 



ROAR will treat the pseudo operation in the same manner as EQR with the excep- 
tion of step 3. That is, it will not reserve any location. 
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The D address must be symbolic, the N address may contain any type of address, 
(except Blank, SKIP or D-ADDR) . It is assumed that when this pseudo-op is used, 
the location will have been previously reserved or there is no need for reser- 
vation. 



Set Up A Header Tag; TAG 



Location 



4- 



Order 



,T,A,<t 



Data 
Address 



4- 



A 



Next 
Address 



4- 



-i — i — 1_ 



Comments 



When a program is being written in large parts or by several people, or makes 
use of symbolically coded subroutines, it becomes difficult to avoid the dup- 
lication of symbolic address codes between the sections. In order to assist 
the maintenance of order instead of chaos, it has been made possible to head 
the various portions of the program, each with its own symbol, sub.iect to 
the following conventions; 

L Symbolic address of five characters in length are not headed. 

2. To symbolic addresses of less than five characters is added the 
header tag and a bit to indicate that heading has taken place. 
THIS TAG WILL NOT APPEAR ON THE OUTPUT .LISTING. 

3. A headed four character symbol will not be confused with a five 
character symbol even though the characters are the same, e.g. 
MASKS is not equivalent to ASKS headed by M, 

4. Double access symbolic codes are not headed. 

5. No heading will be done by the routine until a header has been set 
up. 

6. Since five character symbolic addresses are not headed, they may be 
used to provide communication between portions of the program. 

7. Subroutines written by the Royal McBee Programming Group will make 
use of five character symbols only for entry locations. These sub- 
routines should be headed when used. 

To set up the header, the pseudo-operation TAG is used. The D address is to 
contain the single character header tag that is to be set up and the location 
and N address are to be blank. A header, when established, will be used until 
replaced, or initialization for a new program is entered. Should it be nec- 
essary to remove the header altogether, use the pseudo-op TAG with a blank D 
address. 



SETTING UP CONSTANTS 

The assembly routine provides the programmer with four methods of setting up 
constants for his program. 

1 5 Convert the constant to the form of an instruction and place on the 
coding sheet as such. 
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2 ' Pseudo ope ration HEX. The constant may be converted to its hex equival- 
ent and entered on the following format: 



Location 



4_^i- 



<Z#LaJ 



Order 



,fl , f,* 



Data 
Address 



LU^ 



Next 
Address 



S.LJ& 



i w i 



Comments 



The location may be as for any instruction. For order, the pseudo-op HEX is 
used. The left four characters are placed in the four low order characters of 
the D address; the right four characters are placed in the four low order 
characters of the N address. Leading zeroes need not be entered. 

3. Pseudo operation ALF 

The five characters of the D address of the ALF pseudo operation are read in 
six bit mode and "stored" as indicated by the location. The N address is not 
used. 



Location 



J L 



dSMAd. 



r i 



Order 



.ALF 



Data 
Address 



T C / / 



Next 
Address 



-I 1 1 1 u 



Comments 



4. Decimal Numbers: DEC 



By using the pseudo-op DEC, the programmer may allow ROAR to convert his 
constants to a given "q" and punch them out in the same manner as HEX and 
ALF. 



DBC is used as follows: 

1. The location is the desired location, coded to indicate the proper 
address. 

Use the order code DEC. "~~~ 

Place the q in the D address with its sign, if negative. 
Start the number in the N address and allow it to extend out to 
the right. When punching the tape, place the stop code for the N 
address after the complete number. Place the sign at the left of 
the number (necessary only if negative). Include the decimal point 
at its proper place. 



2. 
3. 

4. 



Location 



-I L_ 



£J- 



Order 



Dec 



Data 
Address 



j i i 



5 



Next 
Address 



- ■ :?■-,/, 7 , £ 



Comments 



43 f 
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The limits are as follows: 

1. For perfect accuracy, the significant figures of the number must 
totvll less than 2^1 (2, 147, 483 , 648) however, the only limit on 
digits is in 2. 

2. The decimal point may be placed anywhere that describes 15 digits, 
but number, sign and decimal point must not total more than 16 
characters o No decimal point is required for integers. 

3. There is no limit on q except that conditions 1. and 2. must be 
fulfilled. 



END OF PROGRAMS END 

When the assembly program reads the pseudo operation code END it: 



1. Computes the check sum for the hex tape and punches it. 

2. Punches a transfer instruction in the hex tape, to the address given 
in the N address, 

3. Stops computation. If started, it will read the next instruction. 
The END pseudo-op does not cause initialization for a new program. 



Location 



r 



Order 



■E7V.J7 



Data 
Address 



T 

J 1 1 I L 



Next 
Address 



MAJM 



Comments 



The above sample will place on the Hex Tape the instruction to transfer to tne 
drum equivalent of the symbol BEGIN. 



THE AVAILABILITY TABLE 

The Availability Table showing the availability status of each memory location 
may be punched out at any time through the use of the pseudo operation PAV for 
Punch Availability. If this is done at all, it is normally following the END 

code. 

The punched availability table consists of the following: 

lo As area of blank tape 

2. The RAV code (see below) needed if the table is to be read at a fut- 
ure time. 

3. The Availability Table itself consisting of the hex representation 
of the contents of the stored table interspersed with initial addres- 
ses of groups. 

4. A check sum. 

Punch the Availability Table 



Location 



J l., I I L 



Order 



£A£ 



Data 
Address 

I I I JL 



Next 
Address 

T 

-I L_J L 



Comments 
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The Availability Table is set up in this manner so that, at a future time, 
additions can be made to a program without the necessity to reassemble the 
original program, but simply to restore the availability as it was when the 
original assembly was finished 6 If an availability table is to be read, it 
is normally the first tape read after loading the assembly program or using 
the pseudo operation NEW (See below) » 



C LEARING THE., SYMBOL .TABLE,;. CLS 

Sometimes it is desirable to continue assembly with the Same availability, 
but with a fresh symbol table * This is especially true When separate program* 
are being optimized to be in memory at the same time> of When maj©r portiofts 
of a program have been coded by two people), 



The pseudo- op 
but everything 


CLS performs this operation,, The Symbol table is zeroed out, 
else, remains unehanggd 6 


Location 


Order 


Data 
Address 


Next 
Address 


Comments 


i 
..;i. » 1 — i — i — 


rC^r* 


I 


i 
• i iii i 





WAIT A,,SEgQN.D,L.HII 

This pse ; ttd© o'gefaiiSn has* be€n included as aft end of t&pi e§d<e» of 
other time it is disifed to nave the §8mputef §t8p dufiftg asse 
action takes place. A degression 6f iM staff button €ause§ the 
continue,; 



f©f any 
, No otkfef 



Location 


Order 


Data 
Address 


Next 
Address 


Comments 


i 
— t.i i i — i — 


. ,A/,r 1( jr 


i 

1 


i 1 

__| L_l— I L_ 


'« 'v 



Reading this pseuds operatloh causes the assemMy prBff&m to tfaftsfef 'control 
to its initiatiizatiott StibrduHnes in drdef to fflafee rgMf ±8f a fttw jjfogtaffi^ 
This order is hSfmliiy tiSed shortly foliSwlBf tfii SMi Sirdiff it is uftfre'ces'sairy 
to USe NEW immediately' after IbacUftg tlie aSigfflfeiy pf8|faffi; 



The following pigfe fcBtttaihs a summary 9f tn§ psSetiHB Spjirati'drtst 



Location 


Order 


Data 
Address 


Next 
Address 


Comments 


- i 


■tffwJ 


i 

l i i i i 


! 

i i i i i 
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Location 


Order 


Data 
Address 


Next 
Address 


Comments 


! 




J i . 


fit 6 


SiX,X,7(,X,X 


i 


Re<:e>-\/e <a Veaiion ' S 






1 1 




i i i 


1 

1 




1 1 


i / 




1 1 I 


rr&m xsaxa thran&h c^u/iljl. 






' 1 




E&R 


1 
1 




.SWM 




,5 


&ZJ 


S^f/rr/yr..f/7-e. SVM t*>i+h an 






1 I 




i i i 


1 
1 


' 


i, i 


l 




i i l 


<zit-/dw r r o-f SO?- A 






1 1 




1 ' i 


1. 
1 




> ■ * 


t 






Reserve Sox/ 










F&y 


1 

1 




s,yK 




A 


,3>J> t R 


S*4jrrJ>o/i2,e SVM L.,,th the 






1 , 1 




i i i 


1 
j 




> • f 






i i 


so. m<° « t/dr-ess <tss )<yn eJ 




„ 1. ..1 .- 




ii i 


1 
1 




■ > 






i i i 


■fa A2>ve 






1 1 




t&ES 


I 
t 




xSyQP 






,5-.X,.0 


AlaAr vjtavat 'able. the Uca- 






1 1 




i i i 


1 
( 




' > 








T~/Oh5 '■::?.■<; £CQ -thrOUCih S JiO 






1 1 




A t V t L 


1 

1 




5,0,0 






52,0 


>Kr : .-• ^Cc: H>eu**hSlO 






, 1 1 






1 




ii i 






i i 


<.<*:*■ <rL]£. 






1 I 




PtAiV 


1 

i 




i i 






i i 


PuftC-h dv<3l lali/itc/ fable 






• 1 




x R t A t V 


1 

,.,, I,.,.,. 




■ i 








Read 4 vat fa hilt iu tat b It 






til 




■ i i 


! 
I 




■ i i 








Cauto^Kitica//<j a /j face/ 






A.A/y 




,H,EX 


f 

l, , 


s 


5*55 




6 


dX 


"Sfcre* hexSSSlCttL . 






i ii 




i i , i 


1 

i 




> i 






< t 


//r AMV 






4 My 




A^F 


1 


/? 


KM 








Re«<( EtRORtn C Bit. »Ue 






i ' 




■ i i 


— 1 

1 




i i 








o» J><?* tape e?ssW7sdta,Afi/Y 






i i i 




TAG 


1 

1 ■ 




, ,c 








Taa a // -feZ/oLd/i/ici symbolic 






• ■ 






f 
I 












*dd r-fi>s?es u//f/i C if then 


i 




> ■ 




i > i 


1 
I 




1 ■ 








c.a/?fa.i/t //?«■«• fha* $ 


T 




i i , 




• i 


1 
| 




1 1 






\ i 


cn.&y ■X.cterj; 






i i 




,/v,r,^ 


1 

- 1 j 




1 J .. 






■ » 


Stop the C0/7lD(jt€v 






i < 




■ i 


1 




I 1 








1 f.X L , 

before, veadwa fh& 






i i 




i i 


1 
1 




■ 1 








neJtf i/f struct /oh 






i i 




E,A/,J> 


! 
I 




1 1 


\ & 


£ 


$JN 


E »rf oT rCO ra iff. 






.. . i i 




1 J ., 


1 
| 




1 ' 








Punch -ftttttl chtck Sum 






ii 




I 1 


1 

1 




1 1 








<*#cf set (so a "tr* >jfP4v 






i i 




1 1 ... 


i 




1 I 






i i 


tateBGIN 






i j 




C,<-J 


1 
I 




1, , .. J . _. 






i i 


C/e*r th« Symbol table, . 






_... i i 




>V,£>W 


1 

1 I 




1 1 






: i 


Tni limine -to o voces? a.. 






i i 




i i 


i 

1 „, 




• ' 








J?euj pvoa ro fn 






a My 


PEL 


! 
I 




, r 


Z+£ 


. 


Z.J.C 


1 ?+<>>■<* the *7c/»£e r- 


y)" | ' 


i i 


i i ,.t 


1 




— i — i — 






1 ' 


-*.ZJ£/ tf/IA/y £b T 



VI 



OPERATION CODES 



The order codes along with the assembly routine's symbolic codes are given 
in the chapter on computer description, however, the following points are 
worthy of consideration. 



SHIFTING 

You will note that one instruction covers both directions of shift. If there 
is a one in the track portion of the D address, the accumulator will be shifted 
left by the amount contained in the sector of the D address, A zero in the 
track portion of the D address causes a right shift in the same manner. 

EXCHANGE 

The EXC (09) order may be used to execute any combination of its functions with 
one command. For example, let us assume it is desired to trade the contents of 
U and L, and copy U into X. This may be accomplished by forming the D track as 
the sum of the bits necessary to perform the required functions: 

U-»L = 1 
L-*U = 2 
U-»X =_4_ 
7 

We would code track 7 for the EXC order. 

If both the 16«s and 32's bits are present in the EXC D track, the status of the 
Lower will be reversed, e.g., if it were eight words long it would become one 
word long. 

SECTOR SEARCH 

There are four instructions that the programmer should consider as to timing, 
two of which will normally be optimized and two of which will normally be 
unoptimized, 

1. The two which are normally optimized: Because at times the EXC 

(09) and MPT (15) orders are to be used on the 8 word lower, they 
delay their action until the drum has turned to the sector of the 
D address. When used for normal operation, it is desirable for 
them to begin operation as soon as possible. Since they will 
normally be given a numeric track address, we suggest that the sec- 
tor 98 (most optimum) be used for the D sector. This allows the 
best optimization of these instructions. 
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The two which are normally unoptimized: PRD (16) and PRU (17), 
Output Interlocking may be bypassed by giving the print orders 
the first optimum sector in the D address. In normal operation 
this is not desirable, being for special cases only,, Since these 
orders will normally be given a numeric D track address, we suggest 
the use of sector 99 for the D sector of print orders. Except for 
recognizing the first optimum sector, the print orders perform no 
complete sector search. 
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VII 



PROGRAMMING USING ROAR 



In preparing to use the Assembly Program, the following sequence will be most 
usual, 

1. Determine the area where the bootstrap program may be placed. It 
requires one track plus the recirculating track. It is suggested 
that it be placed in an area later used for data storage. 

2. Code the instructions to reserve regions and blocks for data storage, 
etc. 

3. Set up equivalents for entry points if desired. 

4. When assembling a large program, it is desirable to run the most 
often used routines first in order to give them the best optimizat- 
ion. This should be borne in mind when coding so that the linkage 
between various routines will be optimum. 

5. Set up header tags if used. 

6. Include the "Change and Transfer" program if there is room. This will 
enable the person doing checkout on the assembled program to get 
about on the computer. 
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VIII 



PROGRAMMING EXAMPLES 



The following three examples are included as a demonstration of some of the 
principles herein discussed. It is assumed that the reader has some coding 
experience. Example 3 is the simplest of the three and probably should be 
considered first by the more inexperienced readers. 

EXAMPLE 1: LINEAR INTERPOLATION 

Given: Table of X. in Region X, 320 values in ascending order. X00001 is 
in Sector DO of a track. 
Table of Y. in Region Y f each corresponding to an X. 

X in U y x < x<x n of x table 

Find: Y corresponding to X„ Exit to FOUND with Y in the upper Accumu- 
lator. 
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Location 


Order 


Data 
Address 


Next 
Address 


Comments 


\t.mt,bk 


,L,P,X 


X\0,O,O,O,/ 


i 




Xo <Z,ddr&xS — *" //?c/#*r register 




■ i i 


1 t i i i 








1 I J I f 


.R.A.L 


J .hA.s.k 


|C,tf.£ 


C.A; 


McfS k -far C o/?tjp€* r*t$Qtf 


jCy/^.c.K 


,LPC 


\c#MM 






5&-h"P r<zfm»i Cau/7i- 




XXM§ 


1 , , ■ A 






7«J/e lookup on $ r*M+<er a r &*&■*( 


i i i i i 


cr&c 


| , £,o,T 






- . •*. r , j '/ v ' 


^ ro&J-igi X 




x.LJX 


, , .l.o.O 






A/0T -facnet ', -fyy ftexi* Zk4cA 


i i i i i 


,C,XF 


x^o.oS.Xj 






H**ve we exceeded "the. "tarJ^l-ef 


■ ii i i 


,TS,C 


f.RXPR 


jCAff 


c/r 


— ■** 7^.^/e &xc-€ €<d-&.4 


i i i i i 


■ i i 


1 i i i i 








i' siA,s,H 


l X,«S l 1 


j/^.7,^3 


J X7 


*J 


A/t /ir 


\C0.£/MT 


, , ,o 


1 i i i \Q 


1 ,^,J 


op 


Coo#f o-f 4>3 


\e t &R>ok 


Jt ,l rr 


1 , , i ,o 






Si~<Sp> U/ii~h X t*t <&CCL'/??tjl<#i~0Y" 




C L ,u 


\ J>,UM? 


f.ov 


N? 


£*)~t with O U&&f>^ 




■ i i 


1 t ■ i i 






r f 


\ . &.OT 


.e.x.c 


j , ,9,9.% 






k-*~ U. (J~*L 




.SJ>A 


\ M.O.LD 






S f&Y-e -t-nuhcl ~F\r*f<zk 


I i i i i 


,-i ,l\ ,L~ 


i f \ \ \ i v»** 






/Vat/A Sector +/ /© J? o-Pu 




.S.TS.V 


\PS. G.C.I 








i f i ■ i 


,E.X1 


\t? t X4.HT 






fc&eti "Ps&C+or ai 1 (J , s-6rf~b&J)(V9lu*L 




,AJ>V 


, .H.O.LP 






' 




.S.AM 


j . . .XJL 






Address erf Xl 


1 iii i 


,s t g,u 


,P.5.e.c,/ 








i i i i i 


,S.A,U 


■ , ,X,2>A 






Address of Xs 


_. i i—i j i. 


.SA.V 


\ , ^,3~^ 


i . . 







>*. 



CD 

3 






*•» 




N» 


(\ 




-«• 


Vs.' 


a 


v> 


ft 


■*^. 


A 


^ 


1 


^0 


H 




2f 




^ 




<fc 




^*>J 




^5 







SO 


'"""•i* 


o 


»4 


4*. 
C3 




C3 


fc 


O 


** 


O 




o 




3£ 




o 




</> 



Royal McBee Corporation 



Location 



Order 



SjSM 



A.PU 



A2R 



,x.s, 



XS 



L 
% 



^y 



i 



yji* 



y,s 



i^*** 



l£ 



s. 



£A 



Ji 



Qa 



A, 



\e, 



M. s. 



T 



JL 



0,0, 



y, 



0,0, 



IAJI 



SAM. 



s,A,U 



S.R.L 



Data 
Address 



SjSxJ 



srr,u 



RA ,u 



SAM 



SJJI 



Rau 



s t Bp 



£LRX 



RJJL 



tek 



J L. 



-1 — l: 



A 



R 



R 



R 



X0P 



A 



6X 



y 



V 



s 



£ 



£ 



X.O.QJ 



y 



c 



o x od 



'.S.I 



ys,x 



c,/ 



LL 



j-i—i 



LLP 



29 



R,C,I 



1 -^r \5? nx 



Next 
Address 



22. 



/? ■ <£ 



>9Q_ 



9 9 



R t c J 



R.CS 



.99 



.O 



AA 



0.00. o \l 



o, 



0.0,0,! 



L 



ieL 



j i_ 



J L 



J l_ 



-i L. 



X.sj 



■ A 1*- 



X.S.Z 



Comments 



4c/drt>s r erf Xs 



Address ofYc 



X-~> L/l 



W 



&r- 



X-Xs 



yL 



* r~^ 1/ 



y£X 



vA ?3> 



A 



.0 



ZA 1 



,0 



Ak 



Xu-Xs 



y,-y. 



cy,-YsYx-Xs) 



tyL-YVLx-xycxL-xr-) 



y 
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^ 


JO 


^ 
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O 
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S- 
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N 


z 
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c/> 
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p 



The Method Used Is : 

1„ Find the next larger X. from the table X 

i L 

2„ Find the surrounding X and Y values from the table. 
3„ Interpolate using the formula Y = Ys +(X-Xs) (Y.. -Ys) 



(X - Xs) 
where subscript S indicates smaller and L larger. 
4„ Exit 



A Flow Chart Might Look Like: 



Initial iz.£ 

I nd e X 

~it\8 control 


\\7 

^ 


1 HtxvcL u>e 
1 exhausted 


YES ^ 




■ 


J the 


<> 


Stop 


1 

4/ 


1 






! 

1 
V 


Cneck 3 -traj-K 
tor X 

I& it -th&r-t ? 


Kio 


Set op pr 
Nkxt trd^K 

■ 




Clear 

Upp<2J~ 


- ? i 


^£5 

V 






\ 


1 


Sot up 

-for 
Computation 






i 
Cor(\puXt Y j 


Exit "to 






y 




rourva 
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Programming Note s 
1. 



The index register is initialized to the first location of the 
table of X s s which is in sector O of a track specified previously 
by a REG pseudo-op. 



2„ The N address of the instruction in INTER has been left blank; the 
location has been left blank on the next instruction, 

3. A mask for comparison is placed in the lower, leaving X in the upper, 

4« The N address is symbolized "CHECK" because of a later reference to 
the same address „ 

5„ A count of 63 is placed in the count portion of the X register and 
the next instruction will be repeated as specified by the command 
in CHECK. 

6„ A table look up is executed by the CMG order and checked by the 
TBC order,, If X has been found, control is transferred to the 
instruction in GOT, if not, a setup for the next track occurs in 
the indexed LDX order. 

7 o For safety, a check for the end of the X table occurs in the CXE 
and TBC orders? If the table has been exceeded, an error stop is 

executed? if not we go back to CHECK another track* 



8„ When X is found we transfer to GOT where an EXC (Exchange) order is 
executed,, The track is nine — we have bits arte and eight,, The I s j 
bit indicates that the contents of the upper' are to be copied in 
the lower. The 8 s s bit indicates that the contents of the X regis- 
ter are to be copied in the uppers g 

Be-fore I L* •* *"*/<,«' 

Search * * **« 



X 






*» 



7> 



N\ 



U: [ ' X ■jofye 



L:[ 



f^tisk 



A f "fey* 



U' 



□: 





/*> 


U*f 




Sea -*c A 


tfV 



La of 



L > (J 



N 






•5 U 



- Y> 






JV 



A/l 



L: 



)c Value 
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so that we can retain X without using temporary storage while 
performing address modification,, 

9. The SAD order after GOT places Lo of the found track in temporary 
storage, 

10, The found sector plus one is shifted, trimmed 3 reduced by one and 
the address of X~ is compiled and stored, 

lie From the address of X_ are found the addresses of X s Y and Y which 

Li o ]j S 

are stored appropriately . 

12. X is restored, Y is computed and control is transferred to FOUND. 

13. Note the selection of RECRC locations. There is no assurance that 
the first reference to RECRC1 will be optimum; it might be as far 
as 7 word times out. However, once we have optimized to RECRC1 
every subsequent reference to recirculating locations is optimum 
through the choice of Sectors 1 and 5 which are 4 word times apart, 

EXAMPLE 2 : POLYNOMIAL EVALUATION 

Fixed coefficients with variable X, 

Determine f(X)„ 

The routine is entered with X in the Upper @1; the instruction to be executed 
in order to exit is in L. The table of a£ @1 is to be in 0700 - 0706 stored 
a through a . In order to exit, the computer is to execute the instruction 

that was found in the Lower upon entry s leaving f(x) in the Upper @1. 



Method 



f(x)=a +a 1 X+a 2 X 2 +a 3 X 3 +a 4 X 4 +a 5 X 5 +a 6 X 6 

The values are such that f(X)<2 for all X<1, 
£(l)-2 
•Vfor this program: &-< X ' <£• I 



To accomplish the evaluation, we may rewrite the equation in 
a form that provides an easy method of solution:. 

f (X)=a +X<a, +X(a +X(a +X(a, +X(a,+X(a.) ) ) ) ) ) 

The evaluation will demonstrate the use of the index register, 
however in the reverse fashion to normal use. 
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Location 
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Programming Notes 

1. A region is assigned for the a.. Values and addresses are assigned 
for critical locations, 

2. EVALU initializes the index register. Note that the initialization 
is placed on the coding sheet following the main loop. This allows 
END and X to be optimized from major use instead of initialization 
which is incidental* 

3. The major loop of 7 instructions develops f(X) in the upper accumulator, 
a. The test-out occurs after adding an a.. 

b„ The summation is multiplied by X and rounded. 

c. The index register is incremented by 12763, which results in 
decrementation by 1. 

d. Exit is to location END which is filled in the initialization. 

EXAMPLE 3: 

2 
Evaluate the function: f(X)= aX+X 



C 
Given X in X @5 
a in a @5 
C in C @> 

Store f (X) in f(X) @5 

Begin at BEGIN 

The exit is in the index register 
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IX 



INPUT TAPE PREPARATION 



The format for punching tapes from coding sheets is fixed and rigid for all 
instructions and pseudo operations,, This was done purposely in an effort to 
reduce the possibility of tape-punch errors, and so that the puncher has 
relatively few rules to remember, 

TAPE PUNCHING FROM CODING SHEETS IS AS FOLLOWS: 



1. There is required a stop code following each of the following fields, 
no matter if it is blank or filled: Location, Order, Data Address, 
Next Address, Comments. 

2. Following each instruction, a carriage return must be on tape. 

3. Leading zeroes need not be punched, except that separating zeroes 
must be punched. 

a. Regional addresses contain the region symbol followed by five 
numeric characters. 

b. Spaces are not accepted in lieu of zeroes. 

c„ If a numeric order is to be indexed, the X must appear to the 
left of two (not one) characters, otherwise no leading zeroes 
need be punched, except that a blank order is illegal. There 
is a difference between a blank address and a zero address; 
a single punched zero is sufficient for distinction. 

EXAMPLE; Punch the Following 
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The Tape Produced Must List Like This: 

*RES*500*1000** 

*REG*A00000*1 63** 

*EQR*BEGIN*1500** 

BEGIN*RAU*A00001 *■** 

*TMI**NO** 

*RAU*AB*YES** 

NQ*SBU*AC*YES** 

*END***Stop for availability punch* 

*PAV***Punch Availability* 

YES *CLU*CODE*** 

*LDC*COUNT*** 

*ADU*A00001*** 

*LDC*COUNT*** 

*ADU*A00065*** 

*STU*TOTAL*GO ON*** 

COTJNT*O*Q*6300** 

*END**** 
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OUTPUT FORMAT 



The Assembly Program makes use of both punch and typewriter output. 

The punch delivers; 

lo A bootstrap program to be stored as indicated by the operator. 

2o The hex tape of the program with check sums at specified intervals. 

3. End and transfer codes. 

The availability table is output on the punch. 

The typewriter output consists of a listing of the input instruction, numeric 
assembled instruction and the punched comments. 

The typewriter output may be bypassed, if desired as in the case of a subroutine, 
by the depression of a sense switch. 
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XI 



OPERATOR 8 S INSTRUCTIONS 



1. Load ROAR by means of the bootstrap included on the tape. The 
computer will stop after loading. 

The method of reading the bootstrap is as follows: 

a. Place the tape in the reader 

b. Select reader input 
C Depress One Operation 

d. Depress Execute Lower 

e. Depress Set Input 

f . Depress Start Read on the reader 

g. Raise Execute Lower 
h„ Depress Set Input 
i. Raise One Operation 

j„ Depress Start Read on the reader 

2. Place the tape of the program to be assembled in the reader and de- 
press the start button. The computer will soon stop to be given 
the track for the Bootstrap Program. If no bootstrap is desired, 
sense switch 8 must be depressed, 

3. All further communication with the program should be through the 
use of pseudo operations. These may be entered manually by 
selecting typewriter entry after an END order on tape, or by stopping 
on tape, or by stopping the computer while reading a carriage return. 

4. If ROAR detects an error, it will print out an indication as to the 
type and stop. If started, assembly will continue from the point 

where location is read. The safest place to restart after correcting 
an error is at the nearest previous instruction which contains a non- 
blank location. 

5. TAB STOPS 

Two typewriter carriage tab stops are required. All others should be 
cleared. Place the tab stops in relation to the left margin at 

increments of 27 and 50. 

6. For your convenience, the following options have been placed on console 
sense switches. The normal condition is represented by the UP position 

in each case. 

Sense Switch Use In Depressed State 

— — — — — * — . - —»^— . ■ ■ ■ a» ~ . i • 

2 Do not list the input on the typewriter 
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4 Use the photo reader for input instead 

of the reader 

8 Do not output a bootstrap 

16 Use the output device selected by print 

code 106 for the decimal output instead 
of the typewriter (may be changed to any 
other selection code) 

32 Bypass the decimal output 
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